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The LiveCode IDE 


Introduction 


This guide details the main components within LiveCodes Integrated Development Environment (IDE). The development 
environment contains all the features you need to quickly create a professional application. The Application Browser 
allows you to find your way around your application as you develop it. The Properties Inspector allows you to set 
appearance and basic behaviors. The Script Editor allows you to add code to each object in your application. In addition 
to these standard tools, the Message Box provides a mini command-line that allows you to develop aspects of your 
application automatically or to test out your application’s code and functionality. 


The Menu Bar 
The File Menu 


The File menu contains commands to open, close and save files; print; and incorporate files into your stack. 


Menu Item Action 


New Stack Opens a cascading menu you can use to choose a stack type to create. When you save the 
stack, LiveCode asks for a file name and location. 


Default Size Creates a stack at the default size (400x400) 


Predefined Creates a stack at the predefined size specified 

Size 

Script only Creates a stack to be used for script only. You will be prompted for a stack name, and the 
Stack script editor for the new stack will launch automatically 

New Creates a new untitled stack in the same file as the active main stack. When you save the 


Substack of substack, it is saved in the main stack’s file. This item is disabled if the active window is not a 
(main stack main stack. 


name) 
Open Opens the main stack whose file you select. If you select a HyperCard file, it is automatically 
Stack... converted into a LiveCode main stack. 


Open Recent Opens a cascading menu containing the names of the 30 main stacks you have most recently 
Stack closed. Choose a name to open the stack. You can change the number of items displayed 
using Preferences. 


Close Closes the active window. This item is disabled if no window is open. 
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Menu Item 


Close and 
Remove 
from 
Memory... 


Import as 
Control 


Image File... 


Audio File... 


Video File... 


Text File... 


Snapshot 


All Images in 
Folder... 


All Audio 
Files in 
Folder... 
All Video 
Files in 


Folder... 


All Text Files 
in Folder... 


New 
Referenced 
Control 


Image File... 


Video File... 
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Action 


Closes the current stack and all stacks in the same stack file as the current stack, and 
removes all stacks in the file from memory. This item is disabled if the active window is not a 
user stack. 


Opens a cascading menu you can use to choose a file and place its contents in a new control 
of the appropriate type. This item is disabled if the active window is not a stack. 


Imports the picture file you choose as a new image on the current card. You can import GIF, 
JPEG, PNG, BMP, XWD, XBM, XPM, or PBM, PGM, or PBM files (and PICT files on Mac OS 
and OS X systems). For more details see the section on the image object. 


Imports the sound file you choose as a new audio clip in the current stack. You can import 
WAV, AIFF, or AU files. For more details, see the section on the audioClip object. 


Imports the video file you choose as a new video clip in the current stack. You can import AVI, 
or MPEG files. For more details, see the section on the videoClip object. 


Imports the text file you choose as a new field on the current card. 


Displays a crosshairs cursor for you to select an area of the screen, and imports a screen 
shot of that area as a new image on the current card. 


Imports all the picture files in the folder you choose, and places them in new images on the 
current card. Subfolders, and other types of files, are ignored. For more details see the 
section on the image object. 


Imports all the sound files in the folder you choose, and places them in new audioClips in the 
current stack. Subfolders, and other types of files, are ignored. For more details, see the 
section on the audioClip object. 


Imports all the video files in the folder you choose, and places them in new videoClips in the 
current stack. Subfolders, and other types of files, are ignored. For more details, see the 
section on the videoClip object. 


Imports all the text files in the folder you choose, and places them in new fields in the current 
stack. Subfolders, and other types of files, are ignored. 


Opens a cascading menu you can use to select a file to reference (i.e. link) to a new control 
of the appropriate type. This item is disabled if the active window is not a stack. 


Creates a new image on the current card and links to the picture file you select in the new 
image object. For more details see the section on the image object. 


Creates a new player on the current card and links to the video file you select in the new 
player object. For more details see the section on the player object. 
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Menu Item 


All Images in 
Folder... 


All Videos in 
Folder... 


Save 


Save As... 


Move 
Substack to 
File... 


Revert to 
Saved... 


Standalone 
Application 
Settings... 


Save As 
Standalone 


Application... 


Page Setup... 


Print Card... 


Print Field... 


Exit 
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Action 


For each picture file in the folder you select, creates a new image on the current card and 
links it with one of the files. Subfolders, and other types of files, are ignored. For more details 
see the section on the image object. 


For each video file in the folder you select, creates a new player on the current card and links 
it with one of the files. Subfolders, and other types of files, are ignored. For more details see 
the section on the player object. 


Saves changes to the current stack and to any other stacks that reside in the same stack file. 
If the file has not yet been saved, you specify the new file’s name and location. This item is 
disabled if the active window is not a stack. 


Saves the current stack, along with any other stacks that reside in the same file, to a new file 
with a name and location you specify. The new file becomes the current working copy. 


Saves the front most substack as a main stack in a file of its own, with a name and location 
you specify. The substack is removed from its previous stack file. This item is disabled if the 
active window is not a substack. 


Throws away any changes to the current stack, along with any other stacks that reside in the 
same stack file. The entire stack file is then reloaded. 


Settings for packaging the current stack for distribution as a standalone application. This item 
is disabled if the active window is not a stack. For more details, see the section onDeploying 
your Application. 


Packages the current stack into a standalone application for distribution using the settings set 
using the Standalone Application Settings window. 

Opens the Page Setup dialog box for the currently selected printer. 

Prints the current card. 


Prints the currently selected field using the revPrintField command. For more details, see the 
section on Printing. 


Closes all open stacks and quits LiveCode. 


The Edit Menu 


The Edit menu contains commands to select, cut, copy, and paste text and objects. 


Menu Item Action 


Undo Reverses the most recent text change, paint action, movement or deletion of an object. 
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Menu Item 
Cut, Copy, 
Paste 
Clear 


Duplicate 


Select All 


Deselect 
All 


Invert 
Selection 


Select 
Grouped 
Controls 


Intersected 
Selections 


Find and 
Replace... 
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Action 


Cuts, copies or pastes the selected text or object. Text and images can be exchanged with 
other programs in this manner. Objects are only available within the currently running instance 
of LiveCode. 


Deletes the selected text or objects, without placing it on the clipboard. 


Makes a copy of the selected object or objects. If the object is a card, the copy is added after 
the current card. If the object is a control, the copy is placed on the current card, below and to 
the right of the original object. This item is disabled if no object is selected. 


Selects all the text in the current field or all the controls on the current card. 


Deselects any selected objects, or removes the insertion point from a field. 


Selects all the unselected objects and unselects all the selected ones. This item does not work 
on text selections. 


If this item is checked, clicking a control that's part of a group selects only that control. If 
unchecked, clicking a control that's part of a group selects the group. 


If this item is checked, dragging with the Pointer tool selects each object that intersects the 
dragged rectangle. If unchecked, dragging with the Pointer tool selects only objects that are 
entirely enclosed by the dragged rectangle. 


Searches for and optionally replaces text in fields, properties, scripts, global variables, or button 
contents. For more details, see the section on Find and Replace. 


The Tools Menu 


The Tools menu contains commands to work with LiveCode's tool palettes and to use stack development tools. 


Menu 
Item 


Browse 
Tool 


Pointer 
Tool 


Tools 
Palette 


Paint and 
Draw 
Tools 


Action 

Chooses the Browse tool for running a project. Allows you to perform user actions such as 
running scripts by clicking buttons, or entering text in a field. 

Chooses the Pointer tool for editing a project. Allows you to select, move, and resize objects. 


Shows or hides the Tools palette for choosing tools for object creation. 


Shows or hides the paint and draw tools in the Tools palette. 
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Menu 
Item 


Project 
Browser 


Message 
Box 


Extension 
Manager 
Extension 


Builder 


Menu 
Builder 
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Action 


Opens the Project Browser window, which lists all open stacks, the cards in each stack, and the 
controls on each card. For more details, see the section on the Project Browser. 


Shows or hides the Message Box. The Message Box is a command line tool that allows you to 
run scripts or perform automated editing operations. For more details, see the section on The 
Message Box. 


Shows or hides the Extension Manager. The Extension Manager is a stack which shows what 
widget and library extensions are currently installed. 


Shows or hides the Extension Builder. The Extension Builder is a stack which aids in the creation 
of widget and library extensions to LiveCode. For more information on creating extensions using 
the Extension Builder, please see the Extending LiveCode guide. 


Creates or changes the menu bar in the currently active stack. For more details, see the section 
on the Working with Menus. 


The Object Menu 


The Object menu contains commands to change the properties of the selected object or objects, to create new objects, 
and to work with groups. 


Menu 
Item 


Object 
Inspector 


Card 
Inspector 


Stack 
Inspector 


Object 
Script 


Card 
Script 


Stack 
Script 


Group 
Selected 


Action 


Opens the Inspector for the currently selected object, allowing you to view and set object 
properties. If more than one object is selected, changes made to the properties are applied to 
each of the selected objects. This item is disabled if no object is selected. For more details, see 
the section on The Properties Inspector. 


Opens the Inspector for the current card, allowing you to view and set card properties. 


Opens the Inspector for the current stack, allowing you to view and set stack properties. 


Opens the Script Editor for the selected objects. If more than one object is selected, a script 


editor window opens for each one. For more details, see the section on The Script Editor. 


Opens the Script Editor for the current card. 


Opens the Script Editor for the current stack. 


Makes the selected objects into a group. This item changes to "Ungroup Selected" if the only 
selected object is a group. For more details, see the section on Groups and Backgrounds. 
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Menu 
Item 


Ungroup 
Selected 


Edit 
Group 


Stop 
Editing 
Group 


Remove 
Group 


Place 
Group 


New Card 


Delete 
Card 


New 
Control 


New 
Widget 


Flip 


Horizontal 


Vertical 


Rotate 
By... 
90° Right 


90° Left 
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Action 


Makes the selected group into individual objects. This removes the group permanently if you visit 
another card before grouping the objects again. This item changes to "Group Selected" if more 
than one object is selected. 


Enters group-editing mode to make changes to the objects in the selected group. This item 
changes to "Stop Editing Group" while in group-editing mode. This item is disabled if no object is 
selected, if more than one object is selected, or if the selected object is not a group. 


Leaves group-editing mode. This item changes to "Edit Group" if the stack is not already in 
group-editing mode. 


Removes the selected group from the current card, without deleting it from the stack. 


Opens a cascading menu containing the names of groups that are in the stack but not on the 

current card. Choose a group to add it to the current card. This item is disabled if all the groups 
in the stack already appear on the current card, or if there are no groups. Note: Only the names 
of top-level groups are listed; groups that are a part of another group are not listed in this menu. 


Creates a new card following the current card. Note: If there are any shared groups on the 
current card when you choose this menu item, they are automatically placed on the new card. If 
a group's backgrouncBehavior is false, they are not placed automatically on new cards. 


Deletes the current card from the front most stack. 


Opens a cascading menu you can use to create a new control. For more details, see the section 
on Control Types. 


Opens a cascading menu you can use to create a new widget control. For more details, see the 
section on Control Types. 


Opens a cascading menu you can use to change the orientation of the selected image or 
graphic. This item is disabled if any object other than an image or graphic is selected. 


Swaps the left and right edges of the selected image or graphic, flipping it around an imaginary 
line drawn from top to bottom of the object. 


Swaps the top and bottom edges of the selected image or graphic, flipping it around an 
imaginary line drawn from left to right of the object. 


Opens a cascading menu you can use to rotate the selected image or graphic. 
Rotates the selected image or graphic by the number of degrees you specify. 
Rotates the selected image or graphic 90 degrees to the right (clockwise). 


Rotates the selected image or graphic 90 degrees to the left (counterclockwise). 
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Menu 
Item 


180° 


Reshape 
Graphic 


Align 
Selected 


Controls 


Left 


Right 


Top 


Bottom 


Make 
Widths 
Equal 


Make 
Heights 
Equal 


Send to 
Back 


Move 
Backward 


Move 
Forward 


Bring to 
Front 
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Action 
Rotates the selected image or graphic 180 degrees (halfway around). 


Allows you to interactively reshape currently selected polygon or curve graphics. 


Opens a cascading menu you can use to line up objects. This item is disabled if no object or 
only one object is selected. 


Moves the selected controls so their left edges are lined up with the left edge of the first control 
selected. 


Moves the selected controls so their right edges are lined up with the right edge of the first 
control selected. 


Moves the selected controls so their top edges are lined up with the top edge of the first control 
selected. 


Moves the selected controls so their bottom edges are lined up with the bottom edge of the first 
control selected. 


Resizes the selected controls so that the width of each one is equal to the width of the first 
control selected. 


Resizes the selected controls so that the height of each one is equal to the height of the first 
control selected. 


Moves the selected objects behind all other objects on the card. This item is disabled if no object 


is selected. 


Moves the selected objects back one layer. 


Moves the selected objects forward one layer. 


Moves the selected objects in front of all other objects on the card. 


The Text Menu 


The Text menu contains commands to change the appearance of text. 


Menu Item 


Action 
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Menu Item 


Text Style 
Options 


Link 


Subscript 
Superscript 


Font 


Use 
Owner's 
Font 


Size 
Use 


Owner's 
Size 


Color 
Use 


Owner's 
Color 


Pen Color 


Align 
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Action 


Applies or removes the selected style from the selected text or the selected object. These 
items are disabled if nothing is selected. 


Makes the selected text, or all text in the selected object into a link. Linked text has special 
properties in LiveCode, for example linked text will receive a linkClicked message when clicked 
on. For more details, see the section on the Field object. 


Moves the selected text below the baseline and makes it smaller. 
Moves the selected text above the baseline and makes it smaller. 


Opens a cascading menu you can use to change the font face used for the selected text or 
objects. 


Causes the font face of the object's owner (if an object is selected) or the object the text is in (if 
text is selected) to be used, removing any font face specific to the selected text or objects. For 
more information on font inheritance, see the section on the Message Hierarchy. 


Opens a cascading menu you can use to change the font size used for the selected text or 
objects. 


Causes the font size of the object's owner (if an object is selected) or the object the text is in (if 
text is selected) to be used, removing any font size specific to the selected text or objects. For 
more information on font inheritance, see the section on the Message Hierarchy. 


Opens a cascading menu you can use to change the font color used for the selected text or 
objects. (This item is disabled if nothing is selected.) 


Causes the font color of the object's owner (if an object is selected) or the object the text is in 
(if text is selected) to be used, removing any font color specific to the selected text or objects. 
For more information on font inheritance, see the section on the Message Hierarchy. 


Changes the selected text, or text used in any selected objects, to use the current ‘pen color’ 
setting (used to draw graphics from the main tool palette). 


Opens a cascading menu you can use to change the text alignment (justification) used for the 
text in the selected objects. 


The Development Menu 


The Development menu contains commands for debugging and for using custom tool stacks. 


Menu Item 


Plugins 


Action 


Opens a cascading menu you can use to open custom tool stacks stored in the Plugins 
folder. 
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Menu Item 


Plugin 
Settings 


Test 


Test Target 


Script Debug 
Mode 


Clear All 
Breakpoints 


Message 
Watcher 


Suppress 
Errors 


Suppress 
Messages 


Suspend 
Development 
Tools 


Caution: Suppressing errors will cause your scripts to fail silently instead of giving an error message in the event 
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Action 


Customizes which messages are handled by the custom tool stacks stored in the Plugins 
folder. 


Simulates deployment to the selected test target. 


Opens a cascading menu you can use to select what device or simulator to use when 
simulating deployment. 


If this item is checked, the debugger is enabled: the debugger window appears when a 
breakpoint is encountered during script execution, and you can enter the debugger when an 
execution error occurs. If unchecked, the debugger is disabled. For more details, see the 
section on Debugging. 


Removes all breakpoints that you've used the Script Editor to mark, in all open stacks. Note: 


This menu item does not affect breakpoints set with the breakpoint command. 


Opens the Message Watcher window, used to view and track messages, function calls, 
getProp calls, and setProp triggers as they are sent to objects. 


Prevents display of the error window when LiveCode encounters a script error. 


Prevents system messages (such as openCard and closeCard) from being sent during 
normal navigation. This option will also cancel any currently pending messages. 


Hides LiveCode's menus, palettes, and other parts of the development environment, so that 
you can preview how your application will look and behave as a standalone, outside the 
development environment. 


LiveCode encounters an error. 


Tip: To also suspend LiveCode libraries, hold down the Shift key while choosing the Suspend Development 


Tools menu item. 


The View Menu 


The View menu contains commands to move around the current stack and to show or hide development tools. 


Menu 

Item Action 

Go First Goes to the first card in the current stack. 

Go Prev Goes back to the previous card in the current stack. 
Go Next Goes forward to the next card in the current stack. 
Go Last Goes to the last card of the current stack. 
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Menu 

Item Action 

Go Goes back to the card you were on before navigating to the current card. 

Recent 

Toolbar Shows or hides the text labels in the Toolbar at the top of the screen. To hide the Toolbar 
Text completely, uncheck both this item and "Toolbar Icons". 

Toolbar Shows or hides the icons in the Toolbar at the top of the screen. 

Icons 


Palettes Shows or hides all open LiveCode palettes. 
Rulers Shows or hides a ruler at the left and bottom edges of each open stack. 


Grid If this item is checked, dragging and resizing objects is constrained by a pixel grid. If unchecked, 
you can drag and resize objects to any location. You can alter the grid spacing in Preferences. 


Backdrop’ Shows or hides a solid or patterned backdrop behind LiveCode's windows. 


Show IDE _ ff this item is checked, elements of the LiveCode development environment appear in lists: for 

Stacks in example, development environment stacks appear in the Application Browser, and LiveCode 

Lists custom properties appear in the Custom Properties pane of the property inspector. If unchecked, 
elements of the LiveCode development environment do not appear in such lists. 


Show If this item is checked, objects whose visible property is set to false are shown. If unchecked, 
Invisible objects whose visible property is set to false remain hidden. 
Objects 


The Window menu 


The Window menu contains the names of open stack windows. 


Menu Item Action 


Send Shuffles the frontmost stack window to the back and brings the second window to the front. 
Window To _ (This item is disabled if only one stack is open or the active window is not a stack.) 
Back 


The Help Menu 


The Help menu contains commands which allow you to find out more about using LiveCode, license your copy of 
LiveCode, get technical support via email, and check the LiveCode site for software updates. For more information, see 
the section on Using the Documentation. 


Menu Item Action 
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Menu Item 


Dictionary 
(API) 


Start Center 


Sample 
Stacks 


Sample 
Scripts 


Beginner's 
Guide 


All Guides 
Tutorials 
User Guide 
Forums 


Technical 
Questions 


Discussion 
List 


Newsletters 
Release Notes 


License 
Agreement 


User Guide 
Support... 


Buy a 
license... 


Check for 
Updates... 


Re-license 
LiveCode 
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Action 


Opens the main LiveCode documentation window, where you can get information about all 
aspects of developing in LiveCode. 


Opens the Start Center. 


Launches revOnline in an external browser 


Opens the Resource Center, which contains many sample scripts, including tutorials on text 
processing and using databases. 


Opens the beginner's guide in an external browser 


Opens the main LiveCode documentation window, which contains all of the user guides 
Launches the online LiveCode lessons portal in an external browser 

Opens the old user guide in an external PDF viewer 

Navigates to the LiveCode discussion forums in an external browser 


Navigates to questions tagged LiveCode on StackOverflow in an external browser 


Navigates to the LiveCode discussion list in an external browser 


Navigates to LiveCode news letters and blogs in an external browser 
Opens the release notes in an external PDF viewer 


Opens the license agreement in an external text editor 


Opens the old user guide as a PDF document 
Loads the support section of the LiveCode web site in your web browser. 


Loads the LiveCode store in your web browser. 


Checks online to see if an update to LiveCode is available. 


Deletes your LiveCode licensing information and restarts LiveCode allowing you to enter a 
new license key. 


The Property Inspector 
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The Property Inspector allows you to view and edit the properties for any selected object. Properties control how an 


object looks and some aspects of an object’s behavior. The Inspector can be accessed by double clicking on a selected 


object, from the toolbar, from the Object menu and from context sensitive menus. 


Pane Selector Lock Icon Action Menu 
| Bem | button *Button" (id 1003) . 
@eeFQ@reaA & & © #7 Settings Menu 
Name Button TH PRPre operty Text 
Label Button 
Tooltip 
Style standard 
Visible ——————————————————— Property Description 
Opaque 
Show Name 
Auto Hilite 
Shared Hilite 
Focus with keyboard 
Focus Border 
Default button 
Disabled 
3-D 
Show Border 
Border Width 2 . 


< 


Figure 9 - Properties Inspector 


Lock icon The lock icon locks the Inspector to the object currently being inspected. Once locked, the 
Inspector will not update when you change selection or switch to Run mode by choosing 
the Browse tool. This allows you to used a locked Inspector to change an object’s properties 
while interacting with your project. Selecting another object and choosing Inspect will create 
another Inspector to inspect the new object. You can use this facility to compare the properties 
of two objects. 


Pane This menu allows you to access each of the different panes within the inspector for a given 
Selector object. 

Action Use the action menu to select another object, edit the script of the current object or send a 
menu message to current object. 

Settings Use the settings menu to configure the settings of the property inspector. 

menu 


https://livecode.com/resources/guide/ 


12/39 


9/2/2021 Guide Docs | LiveCode 


Property Edit the contents of a property by typing into the text area within the Inspector. Press return to 
text set the property and leave the current option selected. Press tab to set the property and move 
on to the next editable text property. 


Property This text describes the object property. By default this text is an English-like description of the 

description property. However you can change this to contain the name of the LiveCode property in the 
Preferences or the settings menu. You may prefer to view the LiveCode property names if you 
are writing scripts that set object properties. 


Important: For documentation on what each individual object property does, hover the mouse over the object until 
you see the script property equivalent. Then look that term up in the LiveCode Dictionary. 


Property Inspector settings 


Tab display style Controls whether to use icons or text for the pane selections. 
Header/Footer size Controls how large the pane selector icons are. 
Property labels Controls whether to use the LiveCode script tokens for property labels or not. 


The Script Editor 


The Script Editor within LiveCode has been designed specifically for LiveCode coding. It includes features to help make 
code more understandable. These include code indentation and color coded syntax highlighting, as well as other 
integrated tools such as a Debugger and syntax Dictionary. You can access the Script Editor for an object by selecting 
the object then choosing Script from the Tool bar. The Script Editor is also available from the Object menu, and from a 
number of other context sensitive menus detailed elsewhere in this guide. Each of the Script Editor's components are 
outlined below. 
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Breakpoint 
1 on mouseUp 


2 local tVar 

put “Hello” into tVar 

local tVar2 

put initialiseVariable() into tVar2 

local tPhrase 

put tVarl & space & tVar2 & "!" into tPhrase 
8 end mouseUp 
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wo 


10 function initialiseVariable 
11 return “World” 
12 end initialiseVariab le 


Breakpoint Manager. 
Syntax Dictionary 
Variable Watcher 


Error Display Next % Previous¢# [) Match Case 








Errors Variables | Documentation Breakpoints Search Results 


@ Noerrors occurred 








Main Script Area 


Display and edit scripts in this area. For more details on how to write a script, see the section on Coding in LiveCode. 
The Script Editor will colorize and format scripts automatically. When typing press tab to manually format the script. 
Press Enter (on the numeric keypad) to compile the script. Press Enter again to close the Script Editor. 


Note: It is not necessary to close the Script Editor to run a script, all that is required is that the script is applied using 
the Apply button. 


Breakpoints Area 


Click next to a line of script to set or remove a breakpoint. A breakpoint specifies a point at which script execution should 
pause and the debugger be loaded. For more details, see the section on Debugging. 


Apply Button 


Compiles the script instantly. Any syntax errors will appear in the Error Display and the script will not compile. A compiled 
script is not saved until the stack that contains it is saved. 


Press Enter (on the numeric keypad) to activate the Compile button. Press Enter again to close the Script Editor. 


Note that none of the message handlers within the script will be available if there is a Script Error during compilation, as 
none of the script will have compiled. 


Errors Pane 


Compile and execution errors will appear here. Double click the icon next to the error details to highlight the line the error 
occurred on in the script (if applicable). 
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1) function initialiseVariable 
12 return "World" 
end initialise Variable 
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Errors Variables Documentation Breakpoints Search Results 


(x) button “Button”: compilation error at line 8 (Expression: missing factor), char 1 





Handler List 


The handler list displays all the functions, commands and handlers which are part of the current script. When a handler 
name is clicked, the script will jump to that handler. 


The currently displayed list of handlers can be filtered by typing in the filter box below it. 


Documentation Pane 


The Script Editor also has a built-in syntax dictionary. When this tab is active a summary of the dictionary entry for the 
keyword which you are currently typing will be displayed. The full dictionary entry can be viewed by clicking Launch 
Documentation. Alternatively you can choose to view the entire entry in place by toggling the Full Document check box at 
the bottom of the documentation pane. 
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808A button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (editing) 


>? > mouseUp He 


@ initialiseVaria © button "Button" 
i [ 


) on mouseUp 
2 local tVar 
3s put “Hello” into tVar 
4 local tVar2 
5 put initialiseVariable() into tVar2 
6 _ local tPhrase 
7 put tVarl & space & tVar2 & “!" into tPhrase 
6 answer 
5 end mouseUp 
10 
1) function initialiseVariable 
12 ~~ sreturn “World” 
13 end initialiseVariable 


Next § Previous¢# [} Match Case 


Errors Variables Documentation Breakpoints Search Results 
command aNSwer 


Displays a dialog box with a message and up to seven buttons. 


answer [/conType] prompt [with button? [or buttons]] [titled windowTitle] [as sheet] 


Da doom 





Search Results Pane 


When you perform a ‘find all’ operation the results will be displayed under this tab. 
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a0A8Aa button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (editing) 

ome) > | nous 3) 
@ initialiseVaria © button "Button" Oe 
mouseUp i 




















! on mouseUp Oo Find and Replace 
2 local tVar : Find what: 
3 put “Hello” into tVar 

4 local tVar2 pal iv] 
5 put initialiseVariable( into tVar2 Replace with: 
6 local tPhrase rs | 
7 put tVarl & space & tVar2 & “!" into! 
6 end mouseUp Look in: 

10. function initialiseVariable 

12 end initialiseVariable 

Lbs 

14 

Ue 

16 

17 

18 

Errors Variables Documentation Breakpoints Search Results 


Results for "put", searching: current tab 


button “Button” of card id 1002 of stack “Untitled 1°(3): put “Hello” into tVar 


button “Button® of card id 1002 of stack “Untitled 1°(5): put initialiseVariable() into tVar2 





button “Button” of card id 1002 of stack “Untitled 1°(7): put tVarl & space & tVar2 & “!" into tPhrase 


Total results found: 3 











Script Tabs 


When multiple scripts are open they will appear as tabs in the Script Editor. Right clicking on the tabs brings up a menu 
which allows a tab to be moved to a new window, closed, or kept while closing all other tabs. Clicking a tab will bring up 
the script it represents. 


The Debugger 


The Debugger helps you track bugs and understand code, by allowing you to pause the execution of your programs or 
step through them line by line. You cause execution to pause by setting breakpoints. When you run your script, execution 
will pause at a breakpoint and you will be able to observe or edit variable values, continue execution or set another 
breakpoint later in the code. Each debugger feature is outlined below: 
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Show Next Statement Step Out Of 
Continue 
Stop Step Step 
Debugging Into Over Debug Context 
aeAea oufo ‘Button" of card id/1002 of stack "Untitled 1" - Script Editor (debugging) 
> G a =) ( button “Button”, line 4 old mouseUp 34 
G initialiseVaria @ button "Button" QO @ 
mouseUp | 
| on mouseUp 
2 local tVar 


3 _— put “Hello” into tVar 

4 local tVar2 

5 _ put initialiseVariable() into tVar2 

6 local tPhrase 

7 ~~ put tVarl & space & tVar2 & “!" into tPhrase 
8 end mouseUp 


9 
| 10 function initialiseVariable 
11 return “World” 
12 end initialiseVariable 

















13 

14 

15 

16 

£4 Find: Next § Previous## [—} Match Case 
Errors Variables Documentation Breakpoints Search Results 
tPhrase 
tVar Hello 
tVarl tVarl 
tVar2 
Continue 


When in debug mode, the Continue button will start running the code from the current position. The program will run until 
the end is reached or another breakpoint is found. 


When you are not in debug mode, the continue button can be used to execute a handler. When you press it, a dialog will 
appear asking which handler you would like to call and, if applicable, which parameters you'd like to pass. On clicking OK 
the Script Editor will call the handler you specified. It will also remember the handler for next time. To change the handler 
called later, choose Entry Point... from the Debug menu. 


Stop Debugging 


Will halt execution at the current point and stop debugging. You will then be able to edit the script. 


Show Next Statement 


The Show Next statement option will return the debugger to the currently executing statement. This is useful if you have 
switched tabs or scrolled during debugging. 


Step Into Next Statement 


Use Step Into to execute the next statement. If the next statement is a command or function ‘Step Into’ will jump to that 
function or command allowing you to execute it line by line. 
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aeea8 button "Button" of card id 1002 of stack “Untitled 1" - Script Editor (debugging) 
PHOc%?2 = | button “Button”, line 5 is] mouseUp 4 
G iritialiseVaria =@ button "Button" Qe 
| on mouseUp 
2 itocal war 
3 put “Hello” into tvar 
@4 local tvar2 
os 
6 loca! tPhrase Step Into 
7 put tVarl & space & tVar2 & *!" into tPhrase 
68 end mouseUp 
3 
10 function initialiseVariable 8 8 8 button “Button” of card id 1002 of stack “Untitled 1*- Script Editor (debugging) 
11 return "World" 
12 end inivalisevariable > r | Sy Ss 2 = | button “Button”, line 10 | inklseVariable | 
: ; GB initialiseVarie e button "Button" ae 
Lal 
1S } on mouseUp 
16 2 local War 
7 3 = put “Hello” into tar 
EQ Find: | @4 local war2 
S put inttialiseVariable() into tvar2 
Errors Variables Documentstion | Breskpoints | Searc 6 local tPhrase 
‘otnses 7 sput tVarl & space & tVar2 &"!" into tPhrase 
Var : end mouseUp 
tVarl 610. function initialiseVariable 
tvar2 1) sreturn “World” 
12 end initialiseVariable 
13 
14 
18 
16 
©] Find ee Previous4 {_) March Case 








Errors Variables | Documentation | Breakpoints Search Ee 


| 


Step Over Next Statement 


Use Step Over to execute a command or function call without stepping through it line by line. The code within the handler 
will run at full speed and execution will pause on the line after the handler call. 
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e088 button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (debugging) 


> | (>) % a =o button “Button”, line 10 ay initialiseVariable | 


D initialiseVaria @ button "Button" Q iC) 
) mouselp % 


1 on mouseUp 
2 local tVar 

3 put “Hello” into tVar 

4 local tVar2 

5 put initialiseVariableQ into tVar2 
6 local tPhrase 
7 
8 
9 
0 




















Step Over 


put tVarl & space & tVar2 & “!" into tPhrase 
end mouseUp 





button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (debugging) 


=a D6 f button “Button”, line 6 ay mouseUp is] 


G initialiseVaria @ button "Button" @ S) 
oO t 


17 sreturn “World” e098 
end initialiseVariable 























1 on mouseUp 

2 local tVar 

put “Hello” into tVar 

local tVar2 

put initialiseVariable() into tVar2 









EQ Find: | 


Errors Variables | Documentation Breakpoints Search 


| 


3 
4 
5 
©6 
7 put tVarl & space & tVar2 & "!" into tPhrase 
6 end mouseUp 
9 
10 function initialiseVariable 
11 return “World” 
12 end initialiseVariable 
13 












3 Find: Next Previous¢# [—) Match Case 








Errors | Variables | Documentation — Breakpoints Search Results 
tPhrase 
tVar 
tVarl 
tVar2 





Hello 
tVarl 
World 










Step Out 


The Step Out function allows you to exit a command or function that you have previously ‘stepped into’. When selected, 
the rest of the current handler will run and execution will pause on the line after the handler call. This is useful to avoid 
stepping through a long command or function line by line when you have identified that the error you are looking for is 
not within that command or function. 
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e808 button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (debugging) 
> Bi (>) % a = / button “Button”, line 10 = initialiseVariable is] 
@ initialiseVaria @ button "Button" QO i) 
a f ) on mouseUp 
2 local tVar 
3 put “Hello” into tVar 
——+ Step Out 
@4 local tvar2 Po 
+ put initialiseVariable() into tVar2 
6 local tPhrase 
7 ~~ sput tVarl & space & tVar2 & “!" into tPhrase 
8 end mouseUp 
9 
| (©10 function initialiseVariable 
11 return “World” 
12 end initialiseVariable 
13 e088 button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (debugging) 
14 
15 > Bi (>) SS a | =t f button “Button”, line 6 by mouseUp Z| 
16 @ initialiseVaria @ button "Button" (as) is 


are mous’ 
EQ Fina: eUp 1 on mouseUp 
2 local tVar 
Errors | Variables | Documentation Breakpoints 3 put “Hello” into tVar 


@4 local tVar2 
5 put initialiseVariable() into tVar2 

©c Weeatrnrase 
7 ~~ sput tVarl & space & tVar2 & “!" into tPhrase 
& end mouseUp 





9 
| 10 function initialiseVariable 
11 return “World” 
12 end initialiseVariable 
13 
14 
15 
16 


17 














EQ Fina: Next Previous## {_} Match Case 
Errors Variables | Documentation Breakpoints Search Results 
tPhrase 
tVar Hello 
tVarl tVarl 
tVar2 World 





Debug Context 


The Debug Context shows you the path of execution up to the current statement you are paused on in the debugger. 
This allows you to identify where you are in your program and which handlers called the current handler you are in. 
Changing the debug context allows you to view variables from different parts of the program. Use this feature to find an 
erroneous command call or a call where wrong parameters were used. 


Variable Watcher 


The Variable Watcher tab allows you to examine the value of variables within your program while it is executing. As you 
step through your code these values will be updated. The variable name is shown in the left column and its value 
adjacent on the right. If a variable's value is too large to be displayed in the pane it will have a magnifying glass next to it. 
Clicking this will bring up a watch window which allows the variable's value to be changed. Variables can also be edited 
by double clicking on their value in the variable watcher. 


Tip: You can see the value of a variable by moving the mouse over the variables’ name in the script field while 
debugging. 


Breakpoint Management 


Use breakpoints to specify where to pause execution in the debugger. You set breakpoints by clicking in the gutter, or by 
right clicking in the Breakpoint Manager at the bottom of the Script Editor and selecting “New Breakpoint”. Each 
breakpoint is associated with a line of code and execution is paused when that line is reached. Alternatively, a condition 
can be assigned to the breakpoint. In this case, execution will only pause if the condition is true when the line is reached. 
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ADA button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (editing) 


Compile s e >! mouseUp 3] 


@ initialiseVaria @ button "Button" O @) 
mouseUp 








) on mouseUp 
2 local tVar 

@3 so put “Hello” into tVar 
4 local tVar2 
5 put initialiseVariable() into tVar2 
6 local tPhrase 
7 put tVarl & space & tVar2 & “!" into tPhrase 
& end mouseUp 





New Breakpoint 


@ Breakpoint (©) Watch 








Condition: 





M @ button “Button”: line 3(no condition £ 





Tip: To see a list of all the breakpoints within a stack, including the script they are in, which line they are on, and 
whether there is a condition attached, click the Breakpoints Manager at the bottom of the Script Editor. The check box 
to the left of each breakpoint can be used to enable or disable the breakpoint. Double click a breakpoint to go to that 
line in the associated object's script. To edit a breakpoint, including adding a condition or changing the line number, 


click the pencil icon. This can also be done by right-clicking on the breakpoint, either in the Breakpoints Manager, or 
the Script Editor's gutter. 
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e08Aa button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (debugging) 


a = | button “Button”, line 4 HA mouseUp 44 


OS 


H 
on mouseUp 


local tVar 
put “Hello” into tVar 


put initialiseVariable() into tVar2 

local tPhrase 

put tVarl & space & tVar2 & “!" into tPhrase 
end mouseUp 


function initialiseVariable 
return “World” 
end initialiseVariable 


£9 Fina: Next} Previous4## [) Match Case 


Errors | Variables Documentation _— Breakpoints Search Results 


M @ button “Button”: line 4 (no condition J 
v @ button “Button”: line 6 (no condition 


v @ button “Button”: line 11 (no condition) 4 
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ANDO button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (editing) 

( Compile) 4% @ PD (" mouseUp EH) 

@ initialiseVaria @ button "Button" QO (@) 
mouseUp 


) on mouseUp 

2 local tVar 

3s put “Hello” into tVar 

4 local tVar2 

5 put initialiseVariable() into tVar2 

6 local tPhrase 

7 put tVarl & space & tVar2 & "I" into tPhrase 
| | revSEBreakpointCondition 


When the breakpoint location is reached, the expression is evaluated 
in the current context and the breakpoint is only hit if the expression 
evaluates to true. 


{_} Condition: 





44; 





Errors Variables |§ Documentation Breakpoints Search Results 





The Breakpoint Manager also allows you to set watches. These are associated with variables rather than lines of code 
and will pause execution when the value of the variable you are watching changes. Alternatively, if the watch has a 
condition attached, execution will only pause if, when the variable's value is changed, the condition is true. To add a 
watch, right click in the Breakpoint Manager and choose “New Breakpoint”. 
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ANA button "Button" of card id 1002 of stack "Untitled 1" - Script Editor (editing) 


Compile % e > f mouseUp a4 


@ initialiseVaria @ button "Button" Q (a) 
iH mouseUp 








on mouseUp 

local tVar 

put “Hello” into tVar 

local tVar2 

put initialiseVariable() into tVar2 

local tPhrase 

put tVarl & space & tVar2 & “!" into tPhrase 
end mouseUp 


N= 


On nw Bw 


New Breakpoint 





© Breakpoint @ Watch 


Handler: f mouseUp KA 
Variable: { Variable Fe 


Zondition: 








Er esults 





M @ button “Button”: line 3(no condition £ 





The Script Editor Menubar 


The Script Editor menubar contains commands to help you edit scripts. 


The File Menu 


The File menu contains commands to print a script or close the Script Editor, with or without saving changes to the script. 


Compile Compiles the current script. 

Save Saves the current stack. 

Close Closes the current script. 

Print Prints the current script. 

Quit Exits LiveCode. Will prompt you to save your work if applicable. 
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The Edit Menu 


In addition to the standard commands to select, cut, copy and paste text, the Edit menu contains the following, script- 
specific commands: 


Revert Takes any changes which haven't been compiled, and removes them from the current script. 


Comment Places a comment character at the beginning of the selected text. If more than one line is 
selected a comment character is placed at the beginning of each line. 


Uncomment Removes comment characters from the selected text. 


Quick Find Opens the “find” field within the Script Editor. 


Find and Brings up the Script Editor's find and replace dialog. 

Replace... 

Go Brings up a dialog box which lets you enter a line number to jump to in the script. 

Variable Variable checking causes LiveCode to perform a stricter check of your scripts. Using any 
Checking variable without declaring it first, or using a literal string without encloning it in quotes causes a 


compile error. This behavior can be useful in tracking down certain subtle problems such as 
misspelling a variable name. 


The Debug Menu 


The Debug menu contains commands to aid in debugging scripts: 


Show Highlights the next line of code to be executed. This is useful if you have changed tab or scrolled 
Next your script during debbuging. 


Step Executes the next line of the handler being debugged. If the next line is a call to another handler, this 
Into command steps into that handler. This menu item is disabled if the debugger is not running. 


Tip: Press F11 to step into the next line. 


Step Executes the next line of the handler being debugged. If the next line is a call to another handler, this 
Over command steps over that call, skipping it and staying within the current handler. 


Tip: Press F10 to step over the next line. 
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Run Resumes normally executing the handler being debugged, starting from the current line. 


Tip: Press F5 to activate the Run button. 


Abort Stops running the handler being debugged. 


Tip: Press control-period (or command-period) to activate the Abort button. 


Toggle Adds/removes a breakpoint from/to the currently selected line. 
Breakpoint 


Variables Changes the tab view at the bottom of the Script Editor to the Variable Watcher tab. 
Breakpoints Changes the tab view at the bottom of the Script Editor to the Breakpoint Manager. 


Entry Point Lets you define which handler execution should begin at when debugging a script. 


Script If this item is checked, the debugger is enabled: the execution of the program will pause when 
Debug a breakpoint is encountered during script execution, and you can enter the debugger when an 
Mode execution error occurs. If unchecked the debugger is disabled. For more details, see the 


section on Debugging. 


The Handler Menu 


The Handler menu contains a list of all handlers in the current script. Choose a handler to go to that handler in the script. 


The Window Menu 


The Window menu contains the names of open script editor windows. 


Autocomplete 


Using Autocomplete 


While typing in the script editor a filtered list of available completions will appear below the selection. Use the following 
keys to navigate the completion list: 


e right arrow - apply the completion or enter group of completions 
e left arrow - leave group of completions 

¢ up arrow - move up the list 

e down arrow - move down the list 


https://livecode.com/resources/guide/ 27/39 


9/2/2021 Guide Docs | LiveCode 
Moving the mouse will hide the completion list to avoid it remaining in place over an area you would like to select. 


Completions include placeholder fields which you can navigate with the tab key. Some completions may have multiple 
placeholders with the same name which will be edited together. Clicking within a placeholder will select it. 
Autocomplete Pro 
Autocomplete Pro provides the following additional features: 

« Completions generated dynamically by introspecting the object being edited and its message path 


e An Autocomplete Snippet Manager dialog is accessible from the script editor menubar to manage a custom set of 
completions. 


Autocomplete Snippet Manager 


An autocomplete snippet provides the information required to match and complete some code in the script editor. The 
Autocomplete Snippet Manager allows the user to manage a custom set of completion snippets. 


Create a new completion snippet by clicking the + icon and delete the currently selected snippet by clicking the -icon. 
The dialog allows entry of the following: 
Display Name - choose a completion snippet to edit or change the display name of the current snippet. 


Priority - A value between 1 and 100 indicating the order the completions should be matched in. Higher priorities will be 
listed before lower priorities. 


Match Scope - Choose whether the completion should try and match when the selection is outside a handler, inside a 
handler or anywhere. A comment completion might be anywhere, a statement completion (unless local, global or 
constant) would be only inside a handler and a handler completion would be outside a handler. 


Match Words - Choose whether to match only all the words of a line, just the word being written or either. A statement 
would be all the words on a line, an expression would be just the current word and a comment would be either. 


Alternate Match String - When matching completion snippets the text of the completion is matched first but in some 
cases that is not suitable or another string would be better to match. Enter a string to try matching if the completion fails 
to match. 


Summary - This field is optional and provides some detail below the completion in the script editor. 


Completion - This is the string to be used when replacing the selection after choosing a completion. The completion 
may be any script and any length. Add placeholders to the completion in the following form: 


${<name>:<type>} 


Where: 


e« name - is the text seen in the script editor 
e type - is used to filter the completions presented for the placeholder one of: 


o statement - any LiveCode command 
© expression - any LiveCode expression 
© identifier - a variable or handler name 


Additionally, it is possible to include multiple placeholders with the same name. When a multiple placeholder is selected 
they are edited at the same time. In this example completion as the user enters the condition a comment is appended to 
the end if with the condition text. Once the condition is complete the user may tab to the -- code line and enter a 
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statement. The tab order is always top to bottom and left to right: 


if S{condition:expression} then 
${-- code:statement} 
end if # ${condition} 


The Message Box 


The Message Box is a command line tool that allows you to run scripts or perform automated editing operations. It allows 
you to try out short scripts, test parts of your program, provides a convenient output window for debugging and can be 
used for editing and setting properties. 


Tip: The Message Box is one of the more useful components in LiveCode when you are starting out and wanting to 
try out simple scripts. You will find you can try out many of the script examples in this User's Guide or in the getting 
started materials on our website simply by copy-pasting them into the Message Box. 


The message box has the following modes: 

Single Line — execute single line and short scripts 

Multiple Lines — execute multiple line scripts 

Global Properties — view and edit global properties 

Global Variables — view and edit global variables 

Pending Messages — view, cancel and edit pending messages 
Front Scripts — view and edit frontScripts 


Back Scripts — view and edit backScripts 





Mode Selector Stack Selector Settings Menu 
(2) Q Message Box (Single Line) 
—|=> fF | 1 & BF & Cuntited 3 
Command Area— | 
Target Action © & 
Lock Icon Results Area 
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Figure 10 — The Message Box in Single Line Mode 


Command _ Type valid LiveCode code into this area. In Single Line mode, separate multiple lines with ; (semi-colon) 
area and press Return to execute. In Multiple Line mode, press return to separate lines, and press Enter to 
execute. 


For example, in Single Line mode, to move all controls on the current card 10 pixels to the left you would 


run: repeat with i = 1 to the number of controls ; move control i relative -10,0; end repeat 
In Multiple Line Mode: repeat with i = 1 to the number of controls 

move control i relative -10,0 

end repeat 


Type control-m to focus the command area and start typing, whenever the Message Box does not have 
the focus. Press control-u when typing to clear the command area. 


In Single Line mode press the Up Arrow key to cycle backwards through the history of previously 
entered and executed scripts. Press the Down Arrow key to cycle forwards. In Multiple Line mode, 
press alt-up arrow or alt-down arrow to cycle forwards or backwards, respectively. Press control-uto 
clear the current command area. 

Typing the name of a global variable or property on its own will result in the line being auto-completed to 
include put in front of the global variable or property, thus the contents of that global will be placed into 
the results area. For example typing: 

time 
Will be auto completed to: 


put the time 


The current time will be placed in the results area. 
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Displays: 

The result function after running code in the command area. 

Any script that uses the put command without a destination container. 

Any script compile error created as a result of attempting to run code placed in the command area. 
Any execution error created as a result of attempting to run code placed in the command area. 


The msg special global will be updated whenever anything is placed in the results area, either by script 
or by directly editing the content of the results area. You can set or retrieve the content of this variable in 
any script. For example, try running the following in the command area: 


put the clipBoardData; replace return with return & return in msg 


The result placed into the results area will contain the current contents of the clipboard, with every return 
character replaced with a second return character. 


Select a stack to work on. Prior to executing any script the defaultStack will be set to the stack displayed 
in this menu. By default the Message Box will choose the front most editable stack. The menu is updated 
whenever you change the front most stack or click on the Message Box. You can use this menu to 
choose an alternative open stack. For example, running the following script in the command area of the 
single line message box: 


put the number of controls 


Would place the number of controls in the current card of the stack displayed in the menu, into the results 
area. 


This option prevents the Stack selector from updating automatically when you change stacks. Use this 
option if you want to run a number of commands on a specific stack regardless of which stack is currently 
in front. 

Use the settings menu to configure the settings of the message box. 


Click the target icon to navigate to the last line of script that executed a put command with the message 
box as its target. 


Message Box settings 


Tab display 


style 
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Header/Footer Controls how large the mode selector icons and footer action icons are. 
size 


Auto update Toggles whether the pending messages as displayed in message box in pending messages 


pending mode are updated automatically or manually. 

messages 

Select The Message Box will attempt to auto complete the typing of a name of an object property, 
intelligence resulting in putting the contents of that property into the results area. You can choose 
object whether the auto-complete should attempt to use the currently selected object, or the object 


directly underneath the mouse. For example, with an object selected, entering: 


width 


Will result in: 


put the width of the selObj 


The width of the currently selected object will be placed in the results area. The se1lobj will 
be substituted with the mouseControl if you choose this option. In the example above, that 
would result in the width of the object underneath the mouse being placed in the results area 
instead. For more details on the selobj function or the mouseControl functions, see the 
LiveCode Dictionary. 


Single and Multiple Line Modes 


Use the Single and Multi-Line modes to execute short scripts. 


Global Properties 


The Global Properties mode allows you to view and edit all global properties. Scroll to select a property from the list on 
the left and select it to view or edit it. Typing a portion of the property name into the Filter field at the top will filter the list 
of properties. Changes to global properties take effect immediately. If a property is ‘read only’ this will be indicated when 
you select it and editing it will have no effect. For more details on Global Properties, see the section on Global 
Properties. 


Global Variables 


The Global Variables mode allows you to view and edit all global variables. Environment variables are shown first, 
followed by other variables. Scroll to find a variable from the list on the left and select it to view or edit it. Typing a portion 
of the variable name into the Filter field at the top will filter the list of variables. Changes to global properties take effect 
immediately. The Show LiveCode UI Variables is an advanced option, discussed in the section on Editing the LiveCode 
User Interface. For more details on Global Variables, see the section on Global Variables. 


Pending Messages 


The Pending Messages mode allows you to view all the current timer based messages that are pending. This is the 
same as the global property the pendingMessages. You can select a pending message to edit its script or cancel it. 
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Tip: You can cancel all current pending messages using the Suppress Messages button on the toolbar. 


Pressing update refreshes the list with the current list of pending messages. The Auto Update mode refreshes the list 
continuously. Note that the Auto Update takes place every 200 milliseconds. If your messages fire more quickly they may 
not be displayed. For more details on Pending Messages, see the section on Timer Based Messaging. The Show 
LiveCode UI Messages is an advanced option, discussed in the section on Editing the LiveCode User Interface. 


Front Scripts & Back Scripts 


These modes list all the scripts currently available as libraries at the front or back of the message path. This is the same 
as the global properties the frontScripts and the backScripts. Select a front or back script to remove it or edit its script. 
For more details on library scripts, see the section on Extending the Message Path. The Show LiveCode UI Scripts is an 
advanced option that displays all of the libraries used by the LiveCode IDE. This is discussed in the section on Editing 
the LiveCode User Interface. 


Stacks In Use 


This mode is the same as the Front and Back scripts mode, except that it displays the stacksInUse global property. You 
can also add a stack directly using the Add button. 


The Toolbar 


The main toolbar provides easy access to commonly used functions. 
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Inspector Code Message Box Group Select Grouped Messages — Errors Sample Stacks Tutorials Resources Dictionary Test 


Figure 11 — The Main Toolbar 
For details on what each toolbar icon does, see the section on the Menu Bar (above). 


To hide and show the text or icons on the tool bar, use View -> Toolbar Text and View -> Toolbar Icons. To hide the 
Toolbar completely, uncheck both options. 


Find and Replace 


The Find and Replace dialog allows you to search your entire application, a portion of the application, multiple files in a 
directory, or stacks specified in your application’s stackFiles property. You can search for object names, scripts, field & 
button text, custom properties, and other properties. After performing a search you can replace the search term with a 
replacement term, either in all of the results or on a selection of the results. 
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Figure 12 — Find and Replace 


Find field Enter a search term. 
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A menu with the following options: 

The current selection — Searches the currently selected objects 
This card — Searches the current card of the front most editable stack 
This stack — Searches the front-most editable stack 


This stack File — Searches the mainStack and all of the subStacks within the stack file 
associated with the current front most editable stack 


This stack file and its stack files — Includes the stacks referenced in this stacks stackFiles 
property. For more details on the stackFiles property, see the section on Structuring Your 
Application. 


> Important: StackFiles are normally set on the mainStack of your application. Ensure that 
you bring the mainStack to the front before searching its stackFiles. If you search using this 
option when a subStack is in front, your search will not include any stackFiles. 


All open stacks — Searches all open stack files that are currently on screen 


All open stack files — Searches all open stacks, including all mainStacks and subStacks in 
each file 


Specific open stack file — Allows you to select a specific open stack file to search 

All stack files in a folder — Searches all the stacks in a folder you specify 

Global variable contents — Searches the contents of currently declared global variables 
Performs the search 


Specifies that the search should be case sensitive (e.g. "a" and "A" are treated as different 
characters) 


Specifies that the Find Field contains a regular expression instead of plain text. A regular 


expression allows you to describe a pattern of text to match. For more details on using regular 


expressions, see the section on Using Regular Expressions below. 


Specifies that fields, cards or groups with their dontSearch property set to true should be 
excluded from the search. For more details on the dontSearch property, see the LiveCode 
Dictionary. 


Specified that the search should be restricted to either marked or unmarked cards. For more 
details on marked and unmarked cards, see mark in the LiveCode Dictionary. 
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Allows you to specific which object properties to search: 
Searches an object’s short name property. 
Searches an object’s script property. 


Searches and objects custom properties and custom property sets. For more details on 
Custom properties, see the section on Custom Properties. 


Searches within field text. 


Searches button text. This includes text in menus. For more information on buttons and 
menus, see the section on Contro/ Types. 


Searches all other commonly used object properties. For more details on exactly what is 
included, see the properties entry in the LiveCode Dictionary. 


Allows you to sort search results by clicking. Drag between the column headers to change 
column widths. 


Displays a list of objects that match the search parameters. 


Removes the currently selected search result in the Search Results area from the list. Once 
removed, the object will no longer be included in any replace operation. 


Specifies a term to use to replace the search term with. 


Replaces the Find Field with the Replace With field in all objects currently listed in the Search 
Results Area. 


Keyboard Shortcuts 


The Development Environment 
Choose run (browse) tool 

Choose edit (pointer) tool 

Toogle between run and edit tools 
Hide or show palettes 

Display context menus when running 


Save all open stacks 


https://livecode.com/resources/guide/ 


Windows / Linux Mac OS X 
Control-9 Command-9 
Conttrol-0 Command-0 


Control-alt-tab Command-option-tab 


Control-tab Command-control-tab 


Control-shift-right click Command-control-shift-click 


Control-alt-s Command-option-s 
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The Development Environment Windows / Linux Mac OS X 

Apply default button in Save dialog Return Return 

Apply non-default button in save dialog Control-1* letter of button Command-1*' letter of button 
Navigation Windows / Linux Mac OS X 

Go to the first card Control-1 Command-1 

Go to the previous card Control-2 Command-2 

Go to the next card Control-3 Command-3 

Go to the last card Control-4 Command-4 

Go to the recent card Control-5 Command-5 

Go to the top or bottom of a field Control-up/down arrow Command-up/down arrow 
Objects Windows / Linux Mac OS X 
Select all Control-a Command-a 
Duplicate Control-d Command-d 
Create card Control-n Command-n 
Nudge control Arrow keys Arrow keys 
Nudge control by 10 pixels Shift-arrow-keys Shift-arrow-keys 
Open object inspector for selection Return Return 

Open stack inspector Control-K Command-K 
Remove styles from selected text Control-; Commanc-; 
Equalize heights of selected controls Control-shift-= Commanc-shift-= 
Equalize width of selected controls Control-= Command-= 
Magnify image with paint tool Control-right-click Command-click 
Apply transparency with paint tool Control-click Control-click 
Constrain paint tool selection to a square Shift Shift 

Constrain object aspect ratio Shift Shift 
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The Code Editor 

Edit script of selected object 
Edit card script 

Edit stack script 

Edit script of object under mouse 
Apply changes 

Apply changes and close 
Apply changes and save stack 
Comment out selected lines 
Remove comments 

Switch to find mode 

Find next 


Find selected text 


Format handler or move to next placeholder 


Next tab in Editor 
Previous tab in Editor 


Show completions palette 


The Message Box 
Open/close message box 
Switch to first tab in message box 


Clear message field 


Scroll through recent messages (single line) 


Scroll through recent messages (multiple line) 


Execute message (single line) 


Execute message (multiple line) 
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Windows / Linux 
Control-e 
Control-shift-c 
Control-shift-s 
Control-alt-click 
Enter 

Enter twice 
Control-s 
Control-hyphen 
Control-shift-hyphen 
Control-f 
Control-g 
Control-Option-f 
Tab 

Control-tab 
Control-shift-tab 


F1 


Windows / Linux 
Control-m 
Control-m 
Control-u 
Up/down arrow 
Alt-up/down arrow 
Return 


Enter 
Control-Return 


Mac OS X 
Command-e 
Commanc¢-shift-c 
Command-shift-s 
Command-option-click 
Enter 

Enter twice 
Command-s 
Command-hyphen 
Command-shift-hyphen 
Command-f 
Command-g 
Command-Option-f 
Tab 

Control-tab 
Control-shift-tab 


F1 


Mac OS X 
Command-m 
Command-m 
Command-u 

Up/down arrow 
Option-up/down arrow 
Return 


Enter 
Control-Return 
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The Debugger 


Step Into F11 
Step Over F10 
Step Out Shift-F 11 
Run FS 

Stop Shift-F5 
Abort Control-. 


The Project Browser 

Scroll through objects 
Expand/contract child objects 
Open object 

Edit script of object 

Edit behavior script of object 


Inspect object 
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Windows / Linux 


Windows / Linux 
Up/down arrow 
Right/left arrow 
Return 
Shift-Return 
Shift-Alt-Return 


Control-Return 


Mac OS X 
F11 

F10 
Shift-F 11 
F5 
Shift-F5 


Commanc-. 


Mac OS X 
Up/down arrow 
Right/left arrow 
Return 
Shift+Return 
Shift-Alt-Return 


Command-Return 
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